home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / wb / huntwin2_1.lha / huntwindows.doc < prev    next >
Text File  |  1993-03-15  |  6KB  |  176 lines
  1.  
  2.              Huntwindows V2.1 by Jörg Bublath
  3.              ================================
  4.  
  5. COPYRIGHT:
  6.  
  7. Huntwindows V2.1 is freely distributable.
  8. Huntwindows V2.1 is free to be spread on public-domain and shareware disks
  9. especially on Fred Fish's AmigaLibDisks, as long as they are sold for a
  10. reasonable charge that is less than US $6 or DM 8.- .
  11. For use in commercial products the permission of the author is required.
  12. Huntwindows V2.1 may be copied and distributed via electronic networks such
  13. as the Internet, also it may be moved on anonymous ftp-servers,
  14. mail-boxes or BBS's.
  15. The Copyright is still by the Author.
  16. You may use the source for your own non-commercial purposes, but you are
  17. not allowed to spread a changed version under the same name. If you think
  18. you have made a useful change contact me, so I may include it.
  19.  
  20. REQUIREMENTS:
  21.  
  22. Kickstart 2.0 (V36) or higher
  23.  
  24.  
  25. PREFACE:
  26.  
  27. Coming with 2.0 you can make screens bigger than the visual size of your
  28. monitor. After I tried to catch windows like requesters etc. on my
  29. double-sized workbench, I got enough and wrote this little tool.
  30. It hangs itself into the VBI to find out which window in being
  31. activated and moves the screen to show the window in full view.
  32. Additionally there are some other related features like remembering
  33. and activating one window for each screen or bring the window or screen
  34. being activated to front.
  35. For full user-comfort, coming with version 2.0, Huntwindows is now a
  36. commodity and can placed into your WBStartup Drawer and has a Graphical
  37. User Interface.
  38.  
  39. USAGE:
  40.  
  41. Template: MOVE/S,SFRONT/S,WFRONT/S,WBONLY/S,DEFPUB/S,ALWAYS/S,
  42.       CX_POPUP/S,HADJ/K,VADJ/K,REMWIN/S from CLI
  43.  
  44. or the same options as worbench tooltypes.
  45.  
  46. MOVE    : Enable ScreenMove() whenever a window is actived - this option
  47.       should always be given, because it's the main purpose of the
  48.       program :)
  49.  
  50. SFRONT    : Enable the ScreenToFront() whenever a window is activated
  51.  
  52. WFRONT    : Do an additional WindowToFront() for windows being activated.
  53.       Due to problems this option won't affect Workbench Drawers.
  54.  
  55. DEFPUB    : If the Intuition FirstScreen is a PublicScreen it will automaticly
  56.       set as DefaultPubScreen, so all windows opening on the default will
  57.       use the FirstScreen.
  58.  
  59. WBONLY    : Only affect windows on the Workbenchscreen - if something
  60.       happens on another screen it will be ignored.
  61.       This option does not take affect on DEFPUB and REMWIN because
  62.       these options live on having other screens.
  63.  
  64. ALWAYS    : Turns off the optimization done when a window is already totally
  65.       visible. This will only have any affect if a HADJ or VADJ
  66.       option is set.
  67.  
  68. CX_POPUP: Show the Graphical User Interface on startup.
  69.       The Interface will be automaticly shown, if Huntwindows is already
  70.       running.
  71.  
  72. HADJ=<a>: Horizontal Adjustment:
  73.       l : Left - means that IF scrolling is necessary, huntwindows
  74.           will try to get the window adjusted to the left edge of
  75.           the screen
  76.       r : Same as above with the right edge
  77.       c : Same as above but centering in the screen
  78.       Everything else will switch the adjustment off
  79.  
  80. VADJ=<a>: Horizontal Adjustment:
  81.       t : Top - means that IF scrolling is necessary, huntwindows
  82.           will try to get the window adjusted to the top edge of
  83.           the screen
  84.       b : Same as above with the top edge
  85.       c : Same as above but centering in the screen
  86.       Everything else will switch the adjustment off
  87.  
  88. REMWIN    : Remember the ActiveWindow for every screen. When switching through
  89.       the screens Huntwindows will activate the last window that was
  90.       active when it was the FirstScreen. A maximum of 64 different
  91.       screens will be remembered - that should be enough, right?
  92.       This option was based on TWA by Matthias Scheler.
  93.  
  94. From CLI you will have to start the program in the background via
  95.  
  96.        run <nil: >nil: huntwindows [options]
  97.  
  98. or whatever you like. If you want to quit Huntwindows simply break the
  99. task or quit it with the "Exchange" Commodity Program.
  100.  
  101. From Workbench adjust the tooltypes and simply start by double-clicking.
  102.  
  103. All the options can be changed by simply using "Show Interface" from the
  104. "Exchange" Commodity Program.
  105.  
  106. THANX:
  107.  
  108. Michael Suelmann for help with the workbench/gadtools
  109. Christian 'cschneid' Schneider for technical support and finding bugs
  110. without ever wanting to use this program.
  111. Markus 'ill' Illenseer for ideas and Aswarm (where I looked up how to do
  112. commodities)
  113. Georg 'Gucky' Hessmann und Matthias 'Tron' Scheler for the idea of the
  114. REMWIN option.
  115.  
  116. TECHNICAL:
  117.  
  118. For reaching this Huntwindows installs a Vertical-Blank interrupt-server,
  119. which tests if the ActiveWindow and the FirstScreen recorded by intuition
  120. differs from the last interrupt and then signals the main-task to move the
  121. display.
  122. Don't mind it taking away too much CPU time - if you have a look at the
  123. source at label 'Interrupt3' you will find that it doesn't do anyhing that
  124. is worth arguing about.
  125.  
  126. HISTORY:
  127.  
  128. Version 1.0:
  129. Worked with patching vectors, which didn't solve the problem of getting
  130. every active window completly.
  131.  
  132. Version 1.1:
  133. Now uses VBI for catching active windows.
  134.  
  135. Version 1.2:
  136. Added some new options and removed some bugs.
  137.  
  138. Version 1.3:
  139. WBONLY and WFRONT option added. WFRONT will not make WindowToFront() on
  140. Backdrop and WBENCHWINDOW windows because it causes problems.
  141. Workbenchsupport added.
  142.  
  143. Version 1.4:
  144. Crash when entering wrong arguments removed
  145. Added DEFPUB option
  146.  
  147. Version 2.0:
  148. Enforcer Hits (old debugging stuff) removed.
  149. Added Commodity support.
  150. Added GUI.
  151.  
  152. Version 2.1:
  153. Removed small bugs.
  154. Added REMWIN feature.
  155.  
  156. FINAL REMARKS:
  157.  
  158. This tool is very nice to be used together with Windowshuffle by
  159. Stefan Sticht, for hopping through the windows and actually seeing them,
  160. when having a BIG workbench.
  161. Huntwindows could do a lot of more interesting things - if I could think
  162. about anything, so if you have ideas please contact me!
  163.  
  164. For problems and ideas, reach me at:
  165.  
  166. EMAIL: bublath@forwiss.uni-passau.de
  167.  
  168. IRC: Skull
  169.  
  170. SMAIL: Jörg Bublath
  171.        Holzheimerstr. 4/E07
  172.        8390 Passau
  173.        Germany
  174.        Phone: Germany-0851-59947
  175.  
  176.